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€ ~ HOT Z-II COMMANDS 


READ mode commands are listed at the top of the keys in the 
top of the two layouts below. Single-step commands are listed 
on the same layout below the corresponding keys. 


WRITE mode commands are listed on the lower layout. FUNCTION 
key commands are not listed. Refer to your command list for 
those. 


A ae type sddress d» set crvsor. Commands are SH/ETED. 
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The enclosed cassette contains the following: 


16k HOT Z followed by Big REM followed by a NAME list. 
These are named HOT Z, EIGREM, and NAMES. The NAME 

|J list requires more than 16K. Load it from 2E82 to 

| AU or from BEB? to A099, for example. Then enter 

|. values at ALNA: 82-2b-82-2bE-FE-SF; hit shift-H. 


64k HOT Z followed by a NAME list for that version. 
These are named HOT Z and NAMES. A printed annotation 
or the NAME list will be available at nominal cost in 
the near future. LOAD the NAME list from E9960 to F184 : 
or any comparable memory space; values to set at FEE 
would then be @@-E@-@@-E@-B2-F1; then press shift H. 


See the notes on loading for loading and backing up the tape. 
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Pius 15 HOI 7-31 


hie. enclosed tape holds versions of HOT Z-11 for 1ók and for 


€ 64) machines. However. HOT Z-1] allows you to create your 


€ 


( 


ow, customized version from the original., The only difference 
betwee ihe two copies on the tape is their memory occupations 
the Jol user hes all of Lhe commands available to the 64k 
use. bul of course much less workspace. lf your projects 
Hilh HO?! Z ere always cramped, then you should consider 
&xperidirnad vour menary end installing one of the modifications 
thal ellows you lo run code above the 22k boundary. (Use the 
fok version as Lhe simplest starting point for the relocations 


described in the later section on Relocating HOT Z.) 


Those of vou with Jok can only run the 1ók version from the 

Lape, However, vent Cam Cest-Ioed the 64k side to be sure that 

the cover comes un undistorted, which indicates a good load. 

htio cou hit a ke, the eé4kh version wilk crash in 16K.) With 

SK cou cet Se ei ther version or create your own version to 
“Give vou access to memory currently occupied by HOT Z. 


We will essiet those of vou who have loading problems by 
@xchenagingd vour tape tor an alternative dubbing. However, 
plesze do not make thinase difficult for all of us by usina the 
Oldest cessette machine in the house and sticking with it. 
The. need conglant cleaning end occasional adjustment of the 
head. Irv borr owing another recorder before returning the 

l eapo Ge a lt is true thet irregularities in tape and cassette 
Cenmoms do make Same Lapes unloadable., and we ask for no 
apologies when vc return e tape. We have exchanged tapes 
widels and throughout the world, and about all we can say of 
the medium ig that anything can happen. 


HOT z-11 combines a line-bv-line assembler, a labellina 
disessenbler, a single-stepper and a simple editor. The 
purpose of HOT Z is to give you a reasonable deoree of direct 
control of your computer, as well as to assist vou in writing 
assoenmb] y~] anaguage programs to extend your control. 


HO © wild cohabit with a BASIC program, although BASIC is a 
fco OV Sengeeae to HOT Z and must be read as data when HOT Z 
)t St) Command. Standard versions of HOT Z reside in high 
mem v but below RAMIO. so if you plan to work extensively 
Myotis bull, HOT Z end BASIC vou should use the command provided 


bs HAT 2 to move RAMTOF below HOT z,. 


momdirimiun requirement far running HOT Z ie some knowledae of 
the Þernedgecimal (hes) rnumber system, which uses the characters 
Q-— end s-F as its 16 digits, These instructions were written 


Will, dhe assumption that vou know the fundamentals of Z9 
mets det dees leeches, It vou do mot, vou should acquire a Z8 

Eg Cur eunmitit] back. The one by Zaks (trom Sybex) 16 useful, but 
hose wero lten spetiticellv for the ZX are generally more 


Simple, if von ere learning, then use HOT Z as a blackboard 
to work out tlhe exercises. 


v | : SIR 
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, RRRR AND CASSETTE CARE 
IL js possible to ruin a data cassette in the Same way as a 
€ floppy disk cen be ruined. A low-quality or poorly maintained 
" cassette player can impose glitches on a tape and make it 
Unloadable. Dirty cassette players will eat tape. Don't take 
the chance. Make a back-up copy first and save this original 
for the day when the back-up fails. 





LOAD your original tape with LOAD "", (LOAD "HOT Z" will work 
too.) With the 16k version, when the cover comes up and asks 
vou to "PRESS ANY KEY TO REGIN", you can make a copy by 
Starting e fresh cassette on RECORD and pressing the 5S key. 
Your computer will output 4 backup copy to tape if you have it 
running. Any other key will start the program, 


In more than 1ék. vou should be aware of the following method 
for duplicatino any ZX tape that loads according to the ROM? s 
BASIC protocol. That protocol requires that the data seament 
"es opposed to the name header) begin loading at address 4099 
ss (VERS) and load as far as the address that comes up in 4614-5 
— KELIND. With that knowledge., you can LOAD any tape as data, 
Provided you LOAD ta an offset from the intended area of the 
ROM's system variables (4009—457C). 


For duplicating HOT Z or any lona program, you need an extra 
lok. thet ig at least 2k of RAM. Then get HOT Z running and 
learn how to use its commands. LOAD the original HOT Z tape 
vie the HOT 7 LOAD command with the cursor set at address 8009 
and with END set to, sey BØBØH just for practice, then stop 
your recorder with the PAUSE key if you have one, but stop it, 
and rewind it immediatly so that you don't forget and start it 
in the middie, which is one way to ruin a tape, 





Now your memory should read out an an offset set of system 
variables, the ones that will be coming in from the tape, and 
the address at 8914-5 (lo-hi) will give you one more than the 
last address to be loaded from the tape. Take that value, add 
the offset, and enter it as prescribed to set END (the TO key, 

— asin TO the END), then start recording the tape from its 
beginning again. This time you will load a full copy, as 
data. of the tapes contents. If you just SAVE the same 
memory contents to another tape, then you have a backup tape 
that will LOAD in the normal manner from BASIC. You have also 
become e copier, and if you persist in that wantonly you will 
cause the extinction of programmers in your species of 
computer, which might foreshadow the ultimate disaster of 
model extinction. | 


kj 
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The more important thing you can do with this technique is to 


change the proaram you have loaded and to save the new 
ver e) Of. I4 vou learn how to manipulate the system variables, 
vou can create sel] f-Joading tapes of great variety. For 


exemplo. vou cen direct where the ROM looks for its first 
BASIC line by setting the start address of that BASIC line 
into 4829-8 (NXLN). If vou are writing machine code for a USR 
Cel] and if your routine sets NXLN before it does its RET to 
BASIC. then your reentry to BASIC will begin with the line 
whose address is in NXLN.  Self-starting tapes also begin 

wiih the line that NXLN points to. 


If NXLN points to VARS memory space, then the BASIC 
interpreter asks no questions but jumps up among the VARS and 
tries tco read what is there as tokenized BASIC code. If you 
oblige it with a properly formatted BASIC line, then it does 
what vou ask (e.d. RAND USR etc.) The important thing about 
inlroducina a machine routine from the variables block is that 
you Cer wipe away ali your initialization code by a call to 
CLEAR, which is 1498 in hex. HOT Z*s initializer jumps into 
the memory space in the printer buffer (4@5C) to do that 
CLEGR, and then starts the program. 


We are frequently asked how to get a copy of HOT Z onto a disk 
Or a fast~-load format. The ZXLR& fast-load program has a data 
mode, which is ideal for saving HOT Z. You can even hook up 
lhe USF cell that enters the ZXLRB command mode as a HOT Z 
command, so that there is no need to go back to BASIC to use 
jl. However, ZXLR8 returns in FAST and HOT Z requires SLOW, 
so wheat you need is an intermediate routine like CALL ZXLR,. 
CALL SLOW, RET. (SLOW is F2B.) Then put the address of this 
routine into a dead key slot in the command file and use the 
corresponding key for the command. 


With a data SAVE, you should save the entire HOT Z program. 
excluding the variables block, and then start HOT Z with its 
USR cell after reloading. With the 64K version, you would 
have to save the HOT Z program and file blocks separately, so 
you would be better off loading the tape to BØØGH, as 
described above, and data saving that block, and then trick 
vour  &vstiemnm into reloading to 49009 when you want to use it. 
We regret. that we have not had the opportunity to experiment 
with the variety of systems that are now available for the 
LX/T8, bul if your system lacks a data SAVE, then you should 
stamp your feet at the door of the producer of that system. 


Li 
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MEMORY MAPS 


Brief memory maps of the versions on tape are as follows: 


16K Versiori 


465 APT 2336 aang SE RF nage S176 DB? TF28 7FBØ Bear 
e-------- $-----2---- 4---------- $--------------- +------- 4--------- +--------- £$----------- — rh See al Se he ace! + 

Systee Display Calculator Your Work Area NAMES HI dump HI Files Hi Program Stack HZ Variables 
Variables File Stack Tabies 


e4k Version 


4689 AMD 4356 44ps BEE TF 2e F3M8 — Fe4E F77R FEAP FES FFA 
4$-------- form qoc ee rtm poo v Sit acon ma pe vere qtio cci dom toccasse for + VEDEL? 
Systes Dispjav Calculator Your Work Aree HI Prporas Work Area WANES Hi dump- Files Stack Hl Vars 
Variables File Stack Tables 


In 64K, the last 256 bytes above FFØØ are unused. 


RUNNING HOT Z-II 


The following section provides an introductory tour of HOT Z. 
The experienced and the adventurous among you may want to 
plunge right im. « If so, arm yourself with the short command 
lists and the keyboard map and try your luck. Details of the 
various commands are available in the later sections of these 
notes. 


If you use HOT Z-II to best advantage, you will discover that 
it gives you a personal command of the machine (the 289) 
itself, with a few exceptions that stem from your hardware. 
If those exceptions bother you then you might find it 
advantageous to improve your hardware. The most interesting 
hardware add-ons that we know of are currently coming from 
John Oliger, 16115 Nassau Lane, Indianapolis, IN 46229. 

These include a display board that turns your ZX/TS into 

ae conventional ZB computer with use of a full 64K memory. 
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SN INTRODUCTORY TOUR 


The cover occupies the initial display file and evaporates 
wher, vou press a key. Then you should see the first screen 
"Dage" of disassembled ROM. Down the left side of the screen, 
you will see the memory-address column, to which everything in 
HOT Z is keyed. These addresses are in hexadecimal and in the 
format accepted as input by the program. In other words, all 
addresses are four hex digits and include leading zeroes but 
no identifying symbols either before or after. The format is 
always there for you to consult as you make entries to HOT Z. 


The address system runs from £O, to FFFF. although the 16k 
memory goes only to 7FFF. In a standard 16K memory. you may 
find various parts of memory reflected into unused address 
areas, as for example a repeat of the ROM code at 290900, BOM, 
and/or at AGM. This is hardware-caused, the result of 
incomplete address decoding. In 64K, you are liable to find 
thet unused addresses above 80400 are cluttered with initial 
garbage., which HOT Z can clean up for you. 


The second column of the disassembly display lists the 
contents of each memory byte, again in hexadecimal, two digits 
per byte, packed together with no spaces between. These 
numbers occur strictly in the order they occur in memory, 
which is not necessarily an easy order for reading. This 
Column ise raw data, as it were, against which any 
"interpretation" can be checked.  Z89 instructions can be from 
one to four bytes in length. A HOT Z routine gets the length 
of any instruction and parses the bytes into instruction- 
length clusters, but it cannot decide whether those bytes hold 
true Z8 code, as here, or simply numbers used as data. That 
decision in the end is up to the reader. On this first page 
of ROM, the first instruction is two bytes long, the second 
three, etc. 


The next column. the NAME column. will hold user-entered 
labels for the corresponding address, along with a few labels 
provided in a permanent file on your original tape. After 

you have annotated a program with these labels, you can SAVE a 
NAME file separately from HOT Z, to be loaded again with 
whetever program the labels pertain to. 


The fourth column presents those particles of electronic 
poetry known es assembly mnemonics. Relative jumps (JR's) are 
listed. as in the sixth line, with their destination address 
(or NAME) rather than the single displacement byte with which 
they are coded. System variables for the ROM are listed by 

en abbreviated name, as in lines 4 and 5. 





You are probably familiar with these first bytes of ROM 
through various FEEks or publications. The first three 
instructions turn off the nonmaskable interrupt that makes 
SLOW mode work, load BC to count up to 16k of memory, and jump 
to the initialization routine at ØSCE. .The fact that only 16k 
is cleared by initialization is very useful if you have a 
larger memory and a reset button. 


The rest of the screen is taken up by RST routines. RST iğ 
prints the character whose code is in ARST ØB handles BASIC 
error reports, RST 18 and 2@ help with interpreting BASIC, and 
RST 28 is the entry to floating-point operations, which are a 
separate sub-language in the ZX. RST 98 and 28 are always 
followed by one or more (for 28) bytes that serve as data 
rather than as machine code. The meaning of such bytes is 
listed in the mnemonics column. 


The current HOT Z display is referred to in these notes as 
READ mode or disassembly. The commands in this mode are 
mainly for moving the display around to give access to 
different parts of memory. The page flip, for example, is the 
ENTER keys hit it to continue the disassembly with the 
instruction following the one at the bottom of the screen. 

For distant moves. you can enter a four-digit hex address to 
the ADDR cursor at the upper-left screen corner. For example, 
try @3CK ta see the memory count and the initial loading of 
RAMTOF. 


During address entry, you can backspace to correct an error by 
using the DELETE key. which works about the same way as it 
does in BASIC. The difference is that DELETE doesn’t blank 
out the entry and that you can't back out of the whole entry 
routine that way. To back out, use the ENTER (NEWLINE) key, 
which works as an escape key in this situation. ENTER is not 
needed after the last hex address digit. 


In READ mode, you can also get to a named routine by entering 
the four letters of an assigned NAME. Try KEYR. You will see 
that the NAMES appear in both the NAME column (referring to 
the current address) and in the mnemonics column (referring to 
ihe target address of CALLS or jumps). 


In general, you can use a NAME in the file as a proxy for its 
address in the READ, WRITE, or One-Step modes of operation. 


Now try the shift-D command from READ mode. This is the 
display switch, and successive strokes of the the same key 
will take you back and forth between the data and the 
disassembly displays. The data display is for examining those 
parts of memory that are used as files of data rather than for 
ZBØ code. The first and second columns contain the single 
address and its content in hex, values that are reflected in 
decimal ir columns four and five. (Use it as a conversion 





table.) The fareriaht column aives the CHR of the contents of 
the eddress and will turn up any BASIC programming or message 


files. Enter. for example, the address ØØ7E to see the 


kevboerd file. Filip through using ENTER to see how the 
keywords are stored, with their final characters in inverse. 
Swiich beck to disassembly while vou're still looking at the 
keyboard file for a taste of what disassembled data (sometimes 
Celled nonsense) looks like. It's up to you to distinguish 
Sense from nonsense when reading a strange program: the 
display switch is there to help you do it. 


lhe WHE column in the data display functions differently from 
Lhe column with the same heading in the disassembly. The 
NAMES in Lhe data display are those that correspond to any two 
Successive bvies, taken in lo-hi order, in the second column. 
(The disassembly displays NAMES assigned to the addresses in 
the first column.) Some NAMES in the data display can crop up 
by chences tor exemple. two NAMES immediately together mean 


thet ei least one is Spurious. 


Use the T command in READ mode to ao to the beginning of the 
NAME file. The NAME file grows downward like a stack, which 
jl jg nol, as vou add new NAMES to memory addresses. Turn on 
the Gata display to see the structure of the NAME file. Each 
NAME Lakes six bytes: the first two hold the address to which 
(he WOME is assigned, hence the listing in the NAME column, 
and the next four hold the NAME itself, which shows in the 
CHR column. Other odd CHR symbols will appear at random for 


some of Lhe address bytes, signifying nothing. 


The dete display is also useful for looking at or creating 
display files. 


You can enter decimal addresses to the ADDR cursor, but these 
must be prefixed by the shift-3 (THEN) command, which 

will pul up a D after ADDR. Try it with 16384, which may be 
familier. Check the conversion with the data display. If you 
enter «a decimal address of less than five digits, then you 
have Lo presse ENTER to tell HOT Z that you've finished. lf 
you entier e decimal higher than 64k, the program will subtract 
64E end dive vou what's left. 


Now oot into disassembly and ao to 1CAA, which is where the 
ROM begins the BASIC function LN. Hit shift-W to turn on 

the floating-point interpreter. You will see here and 

Oy succeedina page flips some of the floating-point calculator 
lenguage. which is described in another section of these 
noies, At ICAF vou will see a rendition of a BASIC error 
repart after RST ØB, in this case for a negative araument to 
the loger 3 Clim. rou can switch off the *-p interpreter by 
hittino shifil-W again, but you will have a more accurate 
rendition of the ROM if vou leave it on. 


The last display on the tour is the Z8£g register display or 
Single-Slepper. Jt is one of the quirks of bilinguality that 
this display mist be entered from an area where the floating- 
point interpreter is not switched on, so first enter an 
address above 40809, say. Then use the shift-S command from 
the disassembly. 


The register display occupies the top three quarters of the 
screen. The left column lists the various Z890 registers; 
please refer io a good 768 reference book if you need an 
explanation of the register names. The double prime, or quote 
sign. is the only symbol available in the ZX character set to 
denote the exchange registers. The exchange flags are listed 
es EXFLAGS. 


The second column Jiste the hex values of the registers’ 
conlenis., Values for the accumulator (A) are listed at the 
left of the column to remind vou that A is the high half of 
the AF register pair, along with H, D and B. The third column 
either converts the second column value to siqned-decimal 
according to the two's complement convention, or, if the 
second column holds an address that has been NAMEd, then that 
NAME is listed in the third column. The fourth column, headed 
by the open parentheses, dives the hex value of the byte 
contained in the address formed by the register-pair values. 
(E... across from HL you will find the byte (HL).) The right 
columr gives the CHR of the byte in the fourth column (for 
the regisler pairs) or of the byte in A. 


The box below the one containing the exchange registers holds 
details on the one-step users stack and the state of the 
flags registers. The user's stack is separate from the main 
machine Slack so that the system can absorb a few stack errors 
without crashing the program. The top four pairs of bytes on 
the user” s stack are shown at the right, along with the NAMES 
for any addresses they might hold, so that you can check to 
see whelher your test routines leave anything behind. The 
mein flags are listed below the exchange flags for easier 
visual association with the conditionals in the program steps 
below. Standard conditional mnemonics are given for the four 
pr war ammers” bits. 


The inverse-printed address at the left in line 18 serves both 
as a cursor and to mark the address of the next step set up to 
be executed by the single-stepper. You can enter any address 
into thal curser just as you would in READ mode, or you may 
also usce a NOME. The ENTER key still serves as an escape 
durina address or NAME entry. but it has another more 
important function as well, which is to run the next single 
SLEM. 





If it^s not already there, enter #888 to the NEXT slot, and 
then notice the contents of the A and D registers just before 
end efter you press the ENTER. This is a fairly safe area and 
you cen experiment with a few more steps. (The things you 
must be careful about are loading into some system variables, 
either ROM's or HOT Z's, and some flag sets. LD (DF CC).HL is 
usually program hari-kari, for example. The SFACE key allows 
vou io skip the step at NEXT. The top line of Z8@ 
instructions represents the previous step executed, and the 
three steps following the one in NEXT are those that will be 
reached if there is no branching. A branched-to step appears 
directly in the NEXT slot; a skipped step disappears from the 
displev. 


For faster debuaging. vou can set breakpoints (shift-4 and 
shifl-2 commands) end use the shift-G command to step through 
the code as far as the first breakpoint encountered. Two 
breakpoints are provided so that your can cover both sides oF 
a conditional branch. You must take care to set breakpoint 
addresses that the code will actually encounter, since 
stopping depends on finding a breakpoint exactly. The BREAK 
key wil] stop the shift-G command if used quickly enough. You 
can display the current breakpoints with the shift-2 command. 


Learners might consider mastering the use of the Single-Step 
first and then using it to see how the various instructions 
end e few resident routines work. A lot of bugs can be 

avoided Phy testing every routine you write with this device. 


Hil shifL-Q (Quit) to get back to the main READ display. You 
will errive at e screen page that starts with the address that 
wes in the NEXT slot of ihe Single-Stepper. If you spot an 
error coming up at the bottom of the Single-Step display, you 
can quit the display, EDIT the error on the disassembly 
display, and get back to where you were in the Single-Step by 
using the shift-S command from READ mode. 


Writing and Editing Z8# Code 


The READ mode is a essentially passive, allowing you to page 
through the memory and examine its contents. The WRITE or 
EDIT modes are there to let you make chances in the memory 
content, provided that memory is RAM. 


There ere essentially three WRITE/EDIT modes. With the 
disassembly display, you can press shift-A and a cursor will 
appear at the top line of the edge of the right column. This 
is the assembly mode. Once vou turn on the cursor, you chance 
the entire command system of HOT Z. The commands available to 
vou with the cursor on are listed as the WRITE-mode commands 
orn the command lists. Hitting ENTER with the cursor in its 
"home" column will quit the WRITE mode and return you to READ, 
where you can readjust the screen to another part of memory. 


In addition to the command set, the up and down cursor 
controls allow you to move the cursor to a given line or to 
Scroll the display page one line up or down by moving the 
cursor up from its top position or down from its lowest 
position. Up scrolling is automatic when vou ENTER a line 
that is third from the screen bottom. 


You may also enter a new Z879 instruction to replace the one 
listed on the cursor line. Just start typing and the existing 
line will disappear. As you type, the delete key and the left 
and right cursor controls will function as you expect them to. 
If the cursor is over the top of a character, your next 
keystroke will replace that character. If you want to insert 
a character, press the EDIT key (shift-1) and a space will be 
Created at the cursor position, with all characters to the 
right of the cursor being shifted one space right. The 
rightmost character in the line (usually a blank) is destroyed 
by this insert command. You cannot jump to another line with 
the up or down cursor command while you are in the middle of 


editing a given line. 


When you have entered the intended ZBØ instruction, hit the ' 
ENTER key to put the proper code into memory. If your entry X 
is in the proper format, the cursor will return to the left 
edge of the column and move one line down, ready to edit the 
next line. If the cursor stays put in the line you are 

wor king on, then it indicates a format error in the mnemonic 
entry. 


HOT Z-1I follows the format of the mnemonics listed in the 
Zilog Z8@ technical manual. This format is essentially the 
same as that listed with the character set in your computers 
instruction manual, with the following exceptions: the RST's 
are followed by a hex byte (98,19,18,2%,28,3%,38) rather than 
decimal and the OUT (N).A and IN A, (N) use the parentheses 
shown here. (N is always a two-digit hex byte.) As a general 
rule, the open parenthesis is always preceded by either & 
Space or a comma, and spaces are always important. 


When HOT Z fails to accepts your entry, it locates the line 
cursor at the first position that does not match its template 
for e proper instruction. Sometimes, however, as with an 
omitted space or an unassigned label, the cursor may appear 
earlier than your particular format error. (For example, it 
will flag the first letter of a label even if only the fourth 
letter is "wrong". ) 


If vou gel stuck and can't get HOT Z to accept what you've 
entered, you can abandon ship and restore the original 
mnemonic by hitting the FUNCTION key. Your recourse then is 
io look elsewhere in the disassembly for the format of the 
instruction vou have been trying to enter, or to look up the 
hex code for that instruction and to enter that in the hex 
column (See below.) to discover how HOT Z lists the mnemonic. 


If you try to back out of a line with the cursor-left key, HOT 
Z will act as if you have tried to ENTER the line. If you 
write al] the way to the end of the line an ENTER will also be 
automatically appended. This occurs with some of the IY+N 
instructions. which just fit in the alloted space. 


You can use e preassigned NAME in an instruction anywhere that 
a ló-bit (four hex digits) number occurs. For example, 

LD HL. (RMTF) is equivalent to LD HL, (4@@4). You must give a 
NAME to a particular address (shift-G command in WRITE) before 
you attempt to use it in an instruction. 


Relative jumps (JRs and DJNZ) are normally entered with the 
destinetion address or NAME. However, for the JRs only (not 
DJNZ) a second form is available for short forward jumps where 
you heven^t yet assigned a NAME but know how far forward you 
want to jump. JR +5 will jump ahead over five bytes. The 
plus sian is required and the displacement is in decimal 

with a range trom Ø to 127. Backward jumps are not catered 
for in this way: it is eesier to look back for the address you 
want tio get to. 


Frovided you do not want one of the last four conditional 
expressions (M, F, FO, or FE), you can use relative jumps all 
the time, and if the destination address is too far away HOT Z 
will convert your JRs to JFs (absolute jumps) rather than 
report an error. The reverse is not true: if you enter a 
very short absolute jump, HOT Z will take your word for it. 
This conversion works well for entry of new code, but you must 
beware when editing in the middie of an existing routine, 
because if a two-byte JR is edited and becomes a three-byte 
JF, then the first byte of the following instruction will be 
Over written. 


There is no ORG command because you are doing the ORG yourself 
with HOT Z. However, direct data entry is possible in the 
assenmbly-edii mode through use of the DB pseudo-op. DE may be 
followed by a quoted string (DB "ABCDE") or by an even number 
of hex digits (DR ØGØF ØDZA). Spaces are ignored in reading 
ihe hex digits, except for the required space after the DE. 
Each pair of hex digits is read as one byte, and a single 
digil lefl over will be ignored. You can write a string or 
series of digits all the way to the end of the line. 


When you hit the end, HOT Z will add the quote if necessary 

end enter ihe line. Upon entry, the editor enters one 

Character (for a string in quotes) or two hex digits per byte 
startling with the cursor address for as many bytes as it takes, 
then resets the screen layout so the next cursor address is at 
the Lop of the screen. The reason for this is that the data you 
have enter ed would be disassembled by HOT Z, producing a 
honsensicel listing. You can look back with the data display to 
assure yourself that what you have entered is indeed there. 


The DE is simply a means of entering data without leaving the 
assembly-edit mode. You should still assign NAMEs to your 
strings or variables and use them in referencing the data. 
The inseri command is recommended when you enter data into an 
existing code block. 


If you want to use the RELOCATE command (described below), 
then you should not mingle small blocks of code and data. 
Keep them in large blocks and keep track of what is where. 


In addition to string entry with DB, you may also enter quoted 
non-inverse characters for direct eight-bit register loads or 
for direct arithmetic/logic operations. LD A,"A" will 
assemble as LD 6,26 and CP "Z" as CF SF. Sixteen-bit (double) 
register loads are not treated in this way. 


Hex Editi Modes 


Hil the shift-E key with the disassembly display to get into 
Lhe main hex edit mode. The "home" column for the cursor in 
this case is between the address and hexcode columns at the 
left of your screen. Cursor controls work: as with the 
assembly-language editor. 


To change the hex content of memory, you may either move the 
cursor over with the cursor-right key or retype the line, 
usinu the keys from Ø to F. With the disassembly display, 
each line holds the correct number of bytes for a single Z8£ 
instruction. If you write a one-byte instruction, the cursor 
will jump to the next line immediately: for multi-byte 
instructions, ihe cursor waits on the line until the required 
number of bytes have been entered, then jumps automatically. 
The purpose of this feature is to allow you to copy hex 
listings from printouts or magazines. You can just type away 
withoul worrying about hitting ENTER at every line, and the 
screen will scroll along with your entries. 


With the edit mode, what you see in the hex column is what you 
get when you make an entry, byte for byte. Edit does not use 
NAMES and you have to calculate the displacements for any 
relative jumps you enter, 


411 of the WRITE-mode commands are available with the hex-edit 
cursor on screen. There is, however, no character insert 
while you are editing a line, and the escape key in the middle 
Of a line igs ENTER rather than FUNCTION. If you need to 
change the first byte of a line after you have started editing 
it. you should escape by hitting ENTER and start over. 
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You can hit the shift-D (display switch) key either before or 
after you have gone to the hex-edit mode in order to obtain 
the dete-edit mode. This mode lets you change one byte at a 
Lime bv writing a new value over the top. This is the mode 
that vou would use for entering hex data files, addresses and 
the like. (Use the DE command from the assembly mode for 
entering text files.) All write commands are available from 
this mode as well. except the NAME (shift-G) command functions 
differently than it does with the disassembly display. 
Shifi-G will no longer assion a new NAME, but can be used to 
write e preassiganed NAME to the NAME column, and the address 
Lo which that NAME belongs will then appear at the cursor 
address and the byte following. The intended use is for 
crealing address files (jump tables). 


Inserting end Deleting Lines (All WRITE/Edit Modes) 


What happens when vou press ENTER after writing an instruction 
is thet HOT Z reads the address of the line you are working 
on. looks up the ihe numeric code of the instruction. and 
enters that code into as many bytes as it takes. Then control 
goes back to the disassembler, which reads back your code into 
Z8Ø mnemonics and revises the screen page accordingly. An 
importanti consequence of this is that when you are editing an 
existing block cf code vou must be careful not to overwrite 
more lines than vou intend to (bv entering a four-byte 
instruction over a two-byte instruction, say) and to watch out 
for new instructions that crop up when you overwrite a long 
inslructian with a short one (one-byte over a three-byte 
instruction. for example). 


If you don*t know the byte length of Z86 instructions. the way 
around the above problem is to use the line-insert (shift-1 

or EDIT) and line-delete (shift-H) commands whenever you are 
editing an existing block of code. 


When you insert or delete a line, a block of code is moved 
eilher to make room or to close up the empty space. One end 
of thet block of code is determined by the cursor: the other 
end must be determined by you before you start your editing 
session. Whenever the WRITE cursor is on. a variable called 
END is displayed in the upper right corner of your screen. 
END marks the other end of the active memory block for an 
inseriion or a deletion or indeed for any block operation, 
such as e clear, e fill, a SAVE, or a transfer. END is set 
with Lhe TO key (as in TO the END) followed by four hex digits 
ar e WHE. On some types of entry errors, you may be asked 
Lwice for the proper value. 
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You should set END whenever you begin an editing session. END 
Should be within your workspace and not overlap with the HOT Z 
program. Jest you move sections of HOT Z around and lose 
control of vour computer. For the insert-line and delete-line 
commands, a special restriction has been. added to the value of 
END. For those operations, END must be within 256 bytes of 
the cursor address, or else you will be asked (automatically) 
Lo enter a new value of END when you give the insert or delete 
command. mt that point, HOT Z will accept any value you enter 
for END and perform the operation. The purpose of this 


behavior is io catch those times when you have forgotten to 


sei END. and io save you from a possible crash. 


For inseriions end deletions, END can be either above or below 
the cursor eddress. The "usual" value would be for END to 
point to an address higher than the cursor address, in which 
case eh insertion would push all values to higher addresses to 
make room for the new instruction. For example. if you insert 
a Vwo-byie instruction at 4C19 with END set to 4C89g, then all 
instructions from 4C19 will be moved two bytes higher until 
4C7E. which will go into 408%, and the original contents of 
AC7F and 4C8?0 will be destroyed. A deletion of a two-byte 
instruction would move all instructions to lower addresses, 
and the contents of 4C7F and 4CBM@ would be duplicated in 4C7D 
end 4C7E. 


Oi the olber hand, if the address in END is lower than the 
cursor address, then an insertion will leave the following 
addresses undisturbed but will push the contents of preceding 
addresses to lower addresses as far as END. For example, with 
END set Lo 4C@@ and the cursor at 4C1%, insertion of a 
Lhrece-bvte instruction would destroy the contents of 4CO09, 
ACO1 and ACET by overwritina them with the contents of 4C, 
4004 and 4085, respectively. Analogously, a deletion would 
duplicale the first three (or N) bytes in the next three. The - 
insertion itself will in this case go into the address 
precedina the cursor address. This feature is useful when 

you are editing in a constricted memory block with blanks that 
may be either above or below. 


Ofler insertions or deletions. the cursor position may have to 
be adjusted for your next entry. (The precedina discussion 
uses "above" and "below" to refer to numerical values of 
addresses, not to screen position, where addresses get higher 
es you go down the screen.) 


When a NAME is assiaqned within a block where you are inserting 
at deleting lines, the NAME will move with the instruction to 
which it is assigned. The displacement assigned to relative 
jumps is not adjusted, so JR TARG may read JR 4C22 after an 
insertion thet pushes TARG from 4C22 to 4C23. Be sure and 
label] all JF destinations and then check that the labels are 
still correct afler an editing session. If you use labels all 
Lhe time. then an error will stand out clearly. 
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When vou are editing the data displav. all insertions and 
deletions affect one byte at a time. 


Using WRITE Commands 


Many of the WRITE commands affect a block of memory and 
require that the END variable be set first to a proper value. 
Use the TO key to set it. Aside from its use for insertions 
end deletions of lines, END is generally set to denote the end 
Of a block of code. whereas the cursor marks the beginning. 

If END is less than the cursor address, the block is generally 
taken lo be null. though sometimes the operation will still 
affect Lhe very first byte. Most operations include the END 
address; the exceptions are SAVE and LOAD, which finish one 
Dyle before. (This makes it effectively impossible to LOAD or 
SAVE address FFFFH, since the next address is (PO, which is 
lese Lhen any cursor address.) 


The block commands are LOAD, SAVE, FIND, transfer, clear, 
fill. print, readdress and relocate, in addition to the line 
insert and delete described above. The simpler commands are 
sSliifl-rm and shift-E. which togale the cursor across the screen 
betwee essembly-edit and hex-edits shift-D. which toogles the 
display between disassembly end data and works only in 

hex -odit because you can't assemble data: shift-G and THEN, 
which allow you to assign or delete a NAME at the cursor 
address: shift-S, which takes you to the single stepper; 
shifl-R, which transfers control to the program beginning at 
the cursor (Novices beware!); and FUNCTION followed by the 
ZTkev. which moves RAMTOF and the stack to the cursor address 
end those below. 


The Lwo cassette commands (LOAD and SAVE) allow you to move 
Lhe contents of individual blocks of memory back and forth to 
end from tepe. Such tapes will only be loadable by the 
corresponding BASIC command if the bytes of memory are in the 
formal of a BASIC program, as explained in the earlier section 
Oi! COpyirng tapes. However, you can Save your machine-code 

pr OC! eur. Grafts and your NAME files with HOT Z, and then load 
(hewn again to continue working on or testing them. The LOAD 
eid SAVE addresses do not have to correspond, but you must 
have (he same block length from cursor to END if you want to 
preserve the whole tape. (This is why you can load BASIC 
Lapes at ean offset.) If you LOAD & tape that is too long for 
Lhe assiqned block. the extra part is cut Offs if you attempt 
la LOAD a tape that is too short for the assigned block, you 
will gel the familiar "searching" pattern on screen when the 
Jive peri of ihe tape ends: hit BREAK to restore HOT Z and the 
por (10i Of memory loaded. If you BREAK during the active 

por Lion of « SAVE, HOT z will restart itself, losing the value 
assigned to END and initializing the stack, the NAME file, and 
any values held in the register display. (Your NAME file can 
be recovered. See the section on NAMing.) 
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LOAD and SAVE bath take tape names, which are entered without 
Quotes after you give the command and before you press ENTER. 
Maximum length for such tape names is the length of the 
Command Jine (top) on which they appear: If you exceed that 
Jengih, HOT Z reads an ENTER and begins to execute the 
Command. 


The TRANSFER command allows you to move the contents of one 
block of memory io another block. The first thing to do is to 
meke eure that your destination block will hold the source 
block wilhout overwriting something you want to keep (or HOT 
Z2). You have the option of copying just the code (shift-T) or 
of copying the code and moving the NAMES assigned to it as 
well (FUNCTION-9o). The original o* the code will not be 
erased by this command. You can copy from ROM but of course 
not into it. : 


To use the transfer command, set END and hit the appropriate 
command keys, This will bring up a DEST cursor at the upper 
left, which asks you for the destination address of the block. 
HOT Z will wait for you to hit ENTER after that address, and 
if vou change your mind or find you've entered it incorrectly 
you can bail out by hitting the SPACE key instead of ENTER. 
After the command has executed, the display will move to the 
address you gave to DEST. 


The FIND command has a Similar protocol to that of transfer. 
In this case. set the cursor to the beginning of a bl^ck of 
memory for which you want to find a match. Set END to the 
last byte of your template. Hit shift-F. An address cursor 
labelled LOOK will come up at the upper left. Enter the 
address at which the search should begin; hit ENTER to proceed 
or SPACE io back out. HOT Z will search 16K (4ØØØH) bytes for 
e metch to the memory from cursor to END: if a match is found, 
the display moves to it: if there is no match, the display 
remains et your template in READ mode. If you find one match 
and want Lo search for another, set the cursor again (shift-A 
or shift-E), move the cursor down a line or two so it doesn't 
point Lo ihe beginning of the found match, and use the 
FUNCTION-F command. If a second match is found, the display 
will move to its if not, the display stays put. (NOTE: If you 
ere searching for a block of 8 zeroes, say. and you find a 
block of 12, then io continue the search you should move the 
cursor down so that there are 7 zeroes or less below it, or 
else vou will find the same string all over again. 


The CLEAR command (FUNCTION-@) will put zeroes in all bytes 
from cursor io END. The FILL command will first ask you for a 
kevseiroke and then fill the block wiin the code for the 
character assianed to that key. If you clear or fill a block 
of HOT Z or the stack, you are likely to crash. 


The PRINT-SCREEN cammand in WRITE will send the contents of 
the screen, starting with the cursor line, to your 244 
printer or to the Memotech parallel interface. Printing will 
continue. interrupted by page flips of the display, until the 
bottom of the screen that contains the END address. If vou 
forget Lo set END, you can BREAK to save paper. 


There is also a hex-arithmetic command, which, though not a 
block command, uses both the cursor address and END. The 
Command is shift-@, and the result is the hex sum and 
difference (END minus cursor address) of the two values, which 
ere displayed in the command (top) line. 


The Readdress (for jump tables) and Relocate (for programs) 
commands are described in a later section of these notes, due 
Lo their complexity. 


A detailed description of all the HOT Z commands is also 
included as a later section intended for occasional reference. 
For normal use. you may want to detach the brief command lists 
and the keyboard map included at the beginning of these notes. 
Other sections will aive you details on naming and NAME files, 
the floeling-point language interpreter, and the program 
relocetor. If there are specific commands which you find 
absolutely opaque or unusable, please write to us for details. 


HOT Z*s Flags 


HOT Z uses the byte at 4721 in the ROM's system variable space 
as B bit-flags, so you could crash the system if you try to 
load that byte. The significance of the bits is as follows: 


Set for disassembly of RST 08h 

Sel for disassembly of RST 28h 

Set for an INSERT in progress 

Set by an input NAME, reset by an ADDR 
Set for data display 

Set for EDIT, reset for WRITE 

Set for a scroll 

Set for window in register display 


NOG SCI RS 


HOT Z also uses 40878 and 4607C to hold a restart address in 
case you fall into a BASIC error trap (RST @8). Occasional 
use is made of the system variables PFC, OLDPFC and STRLEN, 
but. this use does not, to our knowledge, affect the operation 
Qf a co-resident BASIC program. 








DISASSEMBLER FEATURES 


The HOT Z disassembler has been specially programmed for the 
ZX 8r ROM. The special features that are catered for are the 
System variables, the BASIC error reports, and the floating- 
point operations. which make up the 'calculator language" of 


the ZX. 


Abbreviations of system variable names are included in the 
permanent NAME file that loads with the program. The HOT Z 
disassembler always uses the name for a system variable 
whether it is referred to by absolute address (e.g. 400€) or 
by a displacement from IY (IY+#C). However, if you want the 
IY form from the assembler, you must write it out, since the 
assembler will always substitute an address (two bytes) for an 
entered NAME. We have added DENC (debounce) for 4827 (decimal 
16423) and HZFG for 4921 (16417), which is used as a flag byte 
by HOT Z. Since these system variable names are part of a 
NAME file, you can change the abbreviations to suit your own 
taste by entering a new NAME over the top of the old one 
(shifli-G command in WRITE).. 


HOT Z-II also uses the system variables PPC, OLDFFC and 
STRLEN, but this should have no serious on a BASIC program in 
memor vy with HOT Z. CALLS you make to ROM routines should not 
fail for incorrect system pointers. If you use the floating- 
point routines, you should load HL” with 1ØD2 before making 
the CALL. 


When an RST ØBH is executed, the byte following the RST is not 
code but is used as data to generate the BASIC error report. 
HOT Z reads these bytes as ERROR 9, etc., rather than 
generating Z89g mnemonics for them. If you are running the 
disassembler over a block of data, you may see some queer 
results, like ERROR Z. 


An RST 28 is the ZX ROM?^s entry into the floating-point 
language, which is normally disassembled by HOT Z. If you 
find this second language distracting, you can switch off the 
f-p language interpreter with the shift-W command (READ). 

If you want to know what is really going on in the floating- 
poini routines, then consult appendix A of these notes. 


THE COMMAND SET 


àll commands are on shifted keys in order to allow all of the 
alphabet for assembly editing. Following is a description of 
each command. Remember to use the shift key with all commands 


except ENTER and SPACE. 


READ Mode 
Key Description 
bs Sets the cursor to the top line and switches to the 


AND 


assembly-edit mode. The same keystrokes will get you 
from hex-edit to assembly edit. This command works 
only when the disassembly display is on. 


(Shift 2) Switches on or off a display of the stack- 
pointer address in the upper right screen corner. The 
default is Off, because it isn't pretty. but you 
should turn it on when you are test running your own 
routines. There is a small amount of shock absorption 
in the HOT Z stack, but if you should see it changing, 
vou should reset it with the R command (Read) and then 
look very carefully at what you are doing to the stack 
with the routine you are testing. 


The display switch from disassembly to data display or 
back again. The same command works with the hex-edit 
cursor on but not from assembly-edit. 


Sets the cursor to the top line and switches to the 
hex-edit mode. This command also works from assembly- 
edit mode without resetting the cursor line. 


Fix display file. Combs the display file and sets all 
the line endings. Use it when one of your experiments 
messes up the display. If you are in READ mode, this 
command should work even without an ADDR cursor. 


NAME file switch. If you are using only one file, the 
NAMES are switched off or on. If you have two files 
in memory, the command will switch from one file to 
the other. The point of the double NAME file is for 
revising a proaram under development, so that you can 
use the same NAMES at two different addresses. 


Quit HOT Z for BASIC. HOT Z remains resident and can 
be recalled with RAND USR 22528. If you want to 
protect HOT Z, move RAMTOF first with FUNCTION-2 (Write). 


THEN 


TO 
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Restarts HOT Z. Reinitializes variables and resets the 
stack.  Furpose is to clear clutter from the stack. 


Switch to single-stepper. The address in the NEXT and 
LAST slots will be last ones used there. Use this 
command to get back after you have spotted and 
repaired an error in the upcoming code. All old 
single-step register values are preserved. 


Move the display to the start of the NAME file and 
switch to the data display. Use this command as 
preparation for SAVing a NAME file. (Turn on the 
cursor, set END, and SAVE.) 


(Shift-3) Indicates decimal address to follow. The 
command will add another inverse block to the ADDR 
cursor. If the decimal address is less than five 
digits long. hit ENTER after the last. 


(Shift-4) Floating-point disassembler switch. This 
is a flag switch (NOT an on-off switch) which 

switches interpretation of a byte from Z8@ language 

to floating-point language. This command is necessary 
for certain embedded sections of floating-point code 
that are mot preceded by an RST 28 but are jumped to 
from sane other portion of floating-point code. This 
command will not function if the W switch has been set 
to off. If it doesn't work, hit shift-W and try 
aqain. 


Switch the on-off state of the floating-point dis- 
assembler. If turned off, then the TO (Shift-4) 
command will have no effect. If on, then every EF 
(RST 28) will switch to the floating-point disassem- 
bly and every 34H will switch off the floating-point 
disassembly. If you have a stray EF on screen while 
you are in an edit mode, you may get a messed up 
display when you enter code. If so, exit (ENTER) from 
edit mode. use this shift-W command, and go back into 
the active mode without fear. Default state is ON. 


Frints the screen. Useful for small routines. Gives 


you headings and all. Consider using the same command 
from an edit mode for no headings and variable length. 
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WRITE Mode Commancds 


a 


AND 


EDIT 


ENTER 


Switch to assembly-edit mode. Works only when dis- 
assembly display and edit mode are on. Moves the 
cursor horizontally. 


LOAD from cursor to END. Works exactly like the HOT 
i-1 command. If vou enter a tape name (no quotes), 
then the tape is searched for a header with that name. 
I4 no name is entered, then the first band on the tape 
is loaded. The first byte after the tape name is 
loaded to the cursor address and the rest follows. 
Loadina stops at the byte before END. if the tape 
does not contain sufficient data to fill memory to 
END, then the familiar "waiting" pattern comes up on 
Scr een. You may BREAK from this command. BASIC tapes 
begin at 406909H and will load from HOT Z if there is 
space in memory. 


Display switch, data/disassembly. Works only from 
hex-edit mode. 


Switch to hex-edit mode from assembly edit. Moves the 
cursor horizontally. 


Sets the Insert mode for the next instruction (only) 
to be entered. If END iss less than the cursor 
address, then instructions are pushed to lower 
addresses (up the screen) as far as END: if END is 

gr eeter than the cursor address, then instructions are 
moved to higher addresses (down the screen) as far as 
END. Any NAMES assigned to shifted memory area will 
also be shifted so that they stay with the instruction 
to which they were assigned. Relative jumps to or 
from ihe shifted area are not corrected and may 
require a fix-up. If END is 256 bytes or more from 
thie cursor. address. you will be required to confirm 
the END value before the operation proceeds. 


Quit to READ mode when cursor is in "home" column. 
During hex entry, ENTER escapes and leaves the 
original memory contents intact. During mnemonics 
entry, ENTER sends the line contents to the assembler 
for entry into memory. 


Find the string marked by the cursor (first byte) and 
END (last byte). Sets the display to start with the 
found string. If no match is found, then the display 
remains et the template string. To find the next 
match without going back to the template, use 
FUNCTION-F. Do not use other commands between 

the F command and FUNCTION-F. 








FUNCTION During mnemonics entry, escapes and leaves the 
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original memory contents intact. When cursor is in 
the "home" column, FUNCTION changes the cursor to 
inverse F and acts as a prefix to the FUNCTION 
commands listed below. | 


NAME command, This command has two separate effects, 
depending upon whether it is used with the disassembly 
display or the data display. With the disassembly 
display, the effect is to christen that instruction 
with the NAME that you enter to the screen following 
ihe command. As with HOT Z-1, a NAME is four letters 
with at least one beyond F in the alphabet. 

With the data display, the NAME you enter following 
the command must already be assigned to some address. 
HOT Z then looks up the address for that NAME and 
pokes that address to the byte at the cursor address 
end the byte following. then moves the cursor down two 
bytes. Use this form for entering tables of 

addr esses. 


Deletes the instruction at the cursor and closes up 
the code between the cursor and END. END may be 
either lower or higher than the cursor address. If 
END is less than the cursor address, then code is 
moved from lower addresses to close the spaces; if END 
igs greater than the cursor address, then code is move 
from higher addresses to close the space. Code at the 
END address and beyond (moving away from the cursor) 
is preserved. If END is 256 or more bytes away from 
the cursor, then you will be asked each time to verify 
Lhe END value before the command is executed. The 
purpose of this is to prevent your messing up the 
entire memory by forgetting to set END properly. 


Does hex arithmetic. Takes the cursor address (K) and 
END (E) and displays on the top line the sum (E+K) and 
difference (E-K) in hexadecimal. i 


Runs code beginning at the cursor address. Returns to 
HOT Z with the first RET. If you do an extra FOF and 
destroy the return address, then you are on your own. 
(This command differs from the similar one in HOT 2-1, 
which requires a JF back to HOT Z.) Recommended pro- 
cedure is to test your routines first with the single- 
stepper before attempting the R command. 


Sinagle-steps the instruction at the cursor address and 
switches Lo the single-step display with the result of 
Cf thal instruction in the register values and the 
following instruction in the NEXT slot. 
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Transfers code between the cursor address and END 
(inclusive?) to a destination (DEST) that you enter 
following the command. ENTER after DEST executes the 
Command: SFACE after DEST cancels the command: TO 
(ahift 4) after DEST lets you reset END before the 
command is executed. Does not transfer NAMES. To do 
thet. use the FUNCTION-é command. which is otherwise 
identical] to this one. 


(Shift 3) Deletes the NAME at the cursor address from 
tho current NAME file. This command will only affect 
Lhe NAME that vou see on screen with the disassembly 
display, so it is best not to use it with the data 
digpley. 


Frjinas up the END? cursor that allows you to reset the 
END variable. Whenever a block of code needs to be 
marked, il is generally delineated by the cursor 
address and the address assigned to END. Always use 
it to block out a Seament of memory for Insert and 
Delete commands before beqinning to edit. END should 
be set within 256 bytes of the cursor for editing. but 
that restriction can be overridden in any particular 
Case. (See Insert and Delete instructions.) 


SHavEa code from cursor to END-1. Enter a tape name 
without quotes. This is a data SAVE. If you want to 
reload such tapes from BASIC, they must begin with a 
proper set of system variables. (First byte loads to 
49 09H in BASIC.) If you load in a BASIC tape anywhere 
in memory and change it judiciously, then SAVE the 
same block with this command. you should be able to 
reload the result from BASIC. 


Outputs the screen without headings from the cursor 
address to END to your ZX printer or Memotech I/F. 
Will print slightly beyond END to fill out the screen 
orn which END occurs. A variant of the COFY command. 


FUNCTION Commands: Hit FUNCTION first. then the second charac- 


ier 


listed below. (F stands for FUNCTION. ) 


Clears memory from cursor address to END. Take care 
nol to erase HOT Z or your own programs. 


Fills memory from cursor address to END with the code 


for a key thai you specify in response to the KEY? 
prompt. 


jte» T 











F-3 


Moves RAMTOP to the cursor address and moves the 
machine stack to the addresses just below. Be sure 
there is enough clear memory in the new location 
before moving the stack. (Turn on the SF display from 
READ (AND key) and look at RAMTOF (Agiiaá-5): subtract 
for the stack size and allow an extra 4# bytes for 
stack excursions,) 


Dead key. 


Transfer memory contents and assigned NAMEs from a 
memory block (cursor address to END, inclusive) to an 
area beginning with an address entered in response to 
ihe DES] prompt. (See shift T command. ) 


Readdress a jump table (address file) between the 
cursor address and END by a 16-bit displacement value 
entered in response to the DISF prompt. Takes the 
address (lo-hi order) at each pair of memory locations, 
adde the displacement, and re-enters the sum to the 
same locations. 


Relocates 78% code between the cursor address and END. 
Readdresses all CALLS or JFs. Allows a three-way par- 
Lilion of code, variables and (constant) files. 
Requires nine addresses to be first entered at TEM] 
throah TEMS. See the special instruction sheet on 
this command. 


Initializes display window for single stepper. Set 
the cursor to a block of 768 bytes of clear memory and 
give this command. Then go to Single-Step mode and 
use the shift-W switch to see the result of those 
steps that put a character on the screen. 


Continues the search for the string specified in the F 
command. Starts searching from the current cursor 
position. (If, for example, you are searching for a 
block of six empty spaces and you find a block of 
nine, then you should move the cursor down four spaces 
or more, so you don't refind the last eight spaces, 
then the last seven, etc., of the same block.) Uses 
temporary variables that could be overwritten if you 
stop in between for other operations. 
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SINGLE-STEF MODE 


key 


€ AND 


EDIT 


ENTER 


Function 


Displey breakpoints. Lists the current setting of the 
lwo breakpoints on the line below the flags display. 


Backs up. On its first use, this command takes the 
imstruction from the LAST slot at the top of the 
disassembly listing and puts it in the NEXT slot 
(second line). Repeated use with no intervening 
commands will back up one more byte for each keypress. 
Intended use is just to get the last step back. 


Runs ihe instruction in the NEXT slot and reports the 
resulting register values. 


Go (run) to breakpoint. Causes the test routine to run 
from the address in the NEXT slot to either of the two 
breakpoints, which must be set in advance of this 
command. Ereakpoinlis must be set to an address that 
starts a command and not to a byte embedded in a 
command. The GO routine checks the BREAK key after 
executing each line of code, SO you can recover from 
endless loops and sometimes from runawev routines (if 
vou^ore quick) by hitting BREAK. If you are using the 
window, il should be switched off for this command. 


Quit single-step and return to READ. Return address 
is the address in the NEXT slot of the single stepper. 
Register values will be preserved if you reenter from 
READ mode. 


Run a CALL or RST 18. It is your responsibility to 
know that the called routine will not crash and not to 
send RST 1% any unprintable characters. The purpose 
of this command is to shorten the time needed to step 
through complex routines. 


Set register value. The response to this command will 
be REG? in the NEXT cursor. You should respond as 
follows for the various registers: 


for the A register 

for the BC pair 

for the DE pair 

for the Flaas register 

for the HL pair 

for the user's Stack Fointer 
for the IX pointer 

for the IY pointer 
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(S) 


SPACE 


THEN 


TO 


Note that all settings are 16 bits (two bytes) except 
for the one hex byte for A and the mnemonic setting 
for F. The specific flag bits are set or reset 

with the same mnemonics as are reported (M, P, Z, NZ, 
FO, FE. C, NC). Use this command to set up initial 
conditions for testing your routines. 


Skip the step in the NEXT slot and advance to the next 
instruction. Skipped instructions are not listed in 
the LAST slot at the top of the disassembly segment. 


Twin the breakpoints. Sets Breakpoint2 = Breakpointl. 


Set Breakpoiniz. Breakpoints are set just as register 
pairs are, with a NAME or address entry into the NEXT 
cursor. You must set the breakpoints precisely to the 
beginning of the instruction at which you want the 
einale-step to stop, because the stop depends on the 
address of the next step being exactly equal to the 
breakpoint. If the breakpoint points to the second 
byte of a two-or-three-byte instruction, you routine 
will never stop until you crash or hit BREAK. 


Set Breakpointi.  Breakpoints are set just as register 
pairs are, with a NAME or address entry into the NEXT 
cur Sor , You must set the breakpoints precisely to the 
beginning of the instruction at which you want the 
single-step to stop, because the stop depends on the 
address of the next step being exactly equal to the 
breakpoint. If the breakpoint points to the second 
byte of a two-or-three-byte instruction, you routine 
will never stop until you crash or hit BREAK. 


Window switch. Switches the optional full-screen 
displey after each step. The first time you hit 
shift-W switches the display in, the second time 
switches it out, etc. Before you use this command, 
you must first have used the FUNCTION-9 command in 
write mode to set up an alternate display file. 


Frint screen. Copies current screen to printer. 
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ON NAMES AND NAMING 


HOT Z labelling or NAMing system is intended to make the 
programs you are reading or writing more comprehensible when 
they are listed. The four-letter limit is imposed by the 
S2-column ZX display. A space is not a legel character in a 
HOT Z NAME, so use a dash or other punctuation if you want 
fewer than four letters. 


The NAMES themselves and the addresses they assigned to are 
contained in a special file. referred to as the NAME file. A 
NAME file is an ordered list beginning with the highest 
address to which a NAME is assigned (two bytes), then the four 
letters of that NAME, then the next highest address, etc. 
After the last NAME in a file. there must be two zero bytes. 
HOT Z takes care of ordering the NAMES for you. 


A small NAME file is loaded every time HOT Z is loaded. anc 
that file contains four-letter abbreviations of the system 
veriables as well as HOT Z*s variables. You will find a few 
extras in the crowd from 4000 to 4/07D. LINK, TADD, and ASIM 
are used by the single stepper. TEMI through TEMS are slots 
for temporary 16-bit variables for various HOT Z routines. 
(You may use them for any of your own routines for values that 
are not required once the routine is Over, provided your 
routine does nol call the floating-point calculator.) HZET 
(407E—-C) holds HOT Z*s restart address for those cases when 
vou (or HOT Z) are using ROM routines and stumble into one of 
the BASIC error traps. 


The permanent NAME file that loads with HOT Z can be expanded 
to hold any NAMES you add in a session of using HOT Z, or you 
have the option of starting a new file from scratch. In the 
Standard 16 and 64K versions, the permanent NAME file is 
located just above a large work area. and as you add NAMEs the 
file expands downwards in memory (to lower addresses). 


Add a NAME to the file with the shift-G command in WRITE mode 
with a disassembly (not data) on screen. The command will 

Qi ve you a cursor in the NAME column and allow you to enter 

or replace the NAME for that address. A legal NAME is made up 
of any four sinale non-inverse characters with the restriction 
that at least one character must be beyond F in the alphabet. 
If vou foraet that rule, HOT Z will refuse to accept your new 
NAME and will ask you for another. A space in a NAME will be 
accepted and the disassembler will list the NAME, but you will 
not be able to use such NAMES when working with the assembler, 
whicli parses according to spaces and punctuation. Take care 
that your NAMES are unique, or HOT Z will always find only the 
one et ihe higher address when you refer to it. (If you enter 
e NAME to the ADDR cursor before you assion it, then the NAME 
file will be searched and the display will move to that NAME 
if il is already there; otherwise the display stays put.) 
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The THEN key (WRITE) will delete a NAME at the cursor address 
from the screen and from the NAME file. 


The shift-T command (READ) is there to let you find the start 
Of your current NAME file. You may want to check up on it i$ 
your are working under crowded memory conditions to be sure 
the file doesn't overwrite some valuable code. This command 
switches the display to data and moves to the lowest address 
of ihe NAME file. Since the NAME column in the data display 
lists NAMES assigned to addresses formed by pairs of bytes in 
the hex column, the NAME appears horizontally across from the 
first address byte and then vertically opposite the last four 
data bytes. (Be aware that chance occurrences of data can 
look like addresses and cause spurious listings in the NAME 
column of the data display.) 


You should also use the shift-T command when it comes time to 
SAVE the NAMES you have entered in a session. However, you 
will also need to know the end address of your file in order 
to SAVE it. You can call up that end address by entering NEND 
io the ADDR cursor; the end address of the NAME file is listed 
lo-hi there. You can either add 2 to that address to include 
the two zero bytes that act as a terminator, or you can 
remember to zero those two bytes after you reload the tape. 

I^ vou choose the first option, hit shift-T, turn on the 

edit cursor, set END to NEND+2, and SAVE. Record the 
addresses for use when you reload. 


When vou reload a NAME fiie, you must install the start and 
end addresses so that HOT Z will know where to look for that 
file. This is done at the six-byte block labelled ALNA 
(alternate NAMES) in the permanent NAME file. With the data 
display and the edit mode, write the start address twice 
(1o-hi) followed by the NEND address: don't forget to subtract 
2 if vou have included the terminating zeroes. (If you have 
not included them, make sure they are there first.) If 

you don"t do these settings correctly, you will hang up the 
program when you try to switch the new file on. 


The NAME-file switch command is shift-H in READ. It will 
switch from the permanent NAME file to the one you have 
loaded. after you have installed the file parameters at ALNA. 
If you use shift-H without installing the new parameters, the 
effect will be to switch off the NAMEs entirely and you will 
not be able to add new ones. 


You can amalgamate NAME files only if they pertain to separate 
blocks of memory, with the addresses in one block all higher 
ihan those in the other. Then just load the two files end to 
end in the proper order and save them as a single file. 
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HOT Z NAMES 


(FEX 
BERG 
ALNA 
ASIM 
RCE X 
RORO 
RFT 2 
BPT? 
CADR 
CRF t.. 
CHOO 
COUN 
DEE x 
DERG 
EDDC! 
EOFA 
FCEQ 
FENS 
FILE 
HIE X 
HL FG 
1XRG 
] YRG 
KAS DD 
KE YE 
KLIN 
KF'OS 
KRED 
LENI 
LFFO 
LOSI 
NADD 
NASW 
NEND 
NOSI 
NTOF 
OSDF 
OSDF 
QVER 
FOTN 
PRIM 
SPRI 
UNDRA 
USRS 


NOTE: 


7F Df! 
7FDC 
FFE 
4017 6 
7FCE 
7FD&A^ 
7FEC 
7FBE 
7FFE 
7FF9 
6489 
7F H6 
/FCC 
7FD8 
7FF4 
7FEA 
7FF3 
7F9E 
7FER4 
FF OR 
7FDO 
7FD4 
7FD2 
7FFE 
737E 
7FF2 
7FFf 
7DES 
7FE6 
7F ES 
7FC4 
7FFC 
7FF8 
7FFA 
7FFCO 
7FF6 
7FC2 
7FCH 


ZERSIEGL 


7F RA 
7FEB 
7FDE 
TEOB 
7FCB 


IN FERMANENT FILE 


Store for AF’ register pair in single-stepper 
Store for AF register pair in single-stepper 
Alternate NAME file descriptors. Six bytes. 
Single-step simulation area. Five bytes. 
Store for BC" register pair in single-stepper 
Store for BC register pair in single-stepper 
Ereakpoint #1 address 

Ereakpoint #2 address 

Current address for disassembly 

Flag for a bit-op prefix (CE) 

Selects and updates Read mode display 

Counter for printing register values 

Store for DE" register pair in single-stepper 
Store for DE register pair in single-stepper 
Flag for ED prefix 

The END address 

Flag for prefixed bit ops 
Sindle-step window switch: 
Fill character, normally zero for screen clear 
Store for HL" register pair in single-stepper 
Store for HL register pair in single-stepper 
Store for IX register pair in single-stepper 
Store for IY register pair in single-stepper 
Address pointed to by the cursor 

Gets code of keystroke into A: preserves other 
Line number with cursor 

Screen address of the cursor 

Futs cursor address into HL and KADD 

Length of current instruction in disassembly 
Stores address for floating-point interpreter 
Last one-step instruction 

Next address for disassembly 

Switch for NAME lookup 

End of NAME list 

Next one-step instruction 

Most recent leading (low) address of NAME file 
OÜne-step display file for extra window 
Üne-step—displayv point for window, as DFCF 
Overflow warning for User"s stack 

Fointer used in building register-value display 
Space or prime for register display 
Stack-pointer storage bin for stack switches 
Underflow warning for User’s stack 
Sinale-step user’s stack pointer. 


holds CRUN if off 


Sets with 5, 


The high bvte of variables for the 64K version 


is FE 


ll 


rather than 7F. 
other addresses are identical. 


Low byte is the same. 


w SO a 


t 
ae 


cr. 
fy 


W = 


THE FIG REM 





There is a REM generating program that was published in 

e back issue of SYNTAX, and those of you who have it may want 
to install it and use that to create a BASIC line to hold your 
machine code routines. However, you may find the following 
approach more instructive on how to manipulate BASIC from the 
machine level. We have taped Big REM and included it after 
the 16K version of HOT Z on your master tape. Hig REM fills 
all of the available workspace in a 16k memory. 


Eia REM can be used with either version of HOT Z-II, although 
il can only be joined together on a single tape with the 16k 
version. First LOAD HOT Z. You can LOAD Big REM without 
exiting HOT Z bv setting END to 4DC@, putting the cursor at 
4909, and aivina the LOAD command. You can also exit HOT Z 
with the © command, LOAD Rig REM from BASIC, and return to HOT 
Z with the appropriate RAND USR command. One thing you cannot 
do (with 16K) after loading Big REM is to add BASIC lines in 
the conventional way, because your memory is essentially full 
and vou will start overwriting parts of the HOT Z files. 


With Bio REM loaded, you can start writing your machine-code 
routines at 4082, which contains the character zero (10) as a 
marker. as does the last usable byte (4554). When you finish. 
then vou will want to cui off the REM statement so that your 
code just fits. The necessary information to do that is 

€ contained in the chapter on BASIC line formats in your BASIC 
MANUA] s If you look at 4907D and following with Eig REM 
loaded, vou will see the line number in high-low order ((201H) 
end therm the line length in low-high order in addresses 
Af7F-89, That length is f£AZOH, If you add that value to the 
next address, 4981 (the address of the token for REM (EA)) 
then the sum equals the location of the display file (@AZS + 
4ggl = 4436). 


You should use this relationship to "clip off" the BASIC REM 
with your routine in it. If. for example, your last byte of 
code is al address 44060, then you will need a line ending 
(76HFD at 44g1, and a line number at 44802 and 4495. If you 
want that Jine number to be a 2, then put ££ at 44602 and $02 at 
43977. (For higher line numbers, remember that this is a hex 
value, not decimal.) Now you need a line length at 4484-5 and 
e REM token (EA) at 4496. The line length will be the 
difference between this address (44506) and the display file 
address (46460 - 34/6 = gióng9). so put the low byte (AM) into 
4494 and the biah byte (G6) into 4485. That will create a 
second BASIC lines however, the first line is still specified 
as beino the full Jlenath, so you must ao back and change the 
lengll: of the first line. 





In this cese. the Jine lenath plus the address of the first 
token (Chere REM) must sum to the address of the first byte of 
ihe neyt line number, which is 44@2 in our example. Since 
447 - 4081 = 9381. put BI in 487F and ØS in 4089. You can 
now switch inte BASIC with the Q command and delete line ZZ in 
the normal way, Lhen SAVE line 1 for later mergina with your 


BASIC pr oor ein. 


Using HOT Z NAMES with Big REM requires one of two approaches. 
You could start by shortening the REM statement before you 
erite your code in order to leave room for the resident NAME 
lisi to expand. Just clip off a suitable portion as described 
above and come beck to HOT Z with the USR call. A more 
convenient approach would probably be to locate the NAME file 
fœ vour routine et the high end of the big REM statement. 
(See the notes on NAMES and Naming.) 


rau Cen do thet by just writing the address 46552 into the 

Uir ec address slots ei ALNA. then using the H command (Read) 
te swilech to the empty NAME file. Or you might want to 
trensfer all or part of the permanent list into the REM before 
you do Lhe switch. (Re careful not to transfer over the end 
uf Lhe REM statement. which would destroy the line end and the 
beainning of the display file.) 


if you put the NAMES for your routine in the top of the REM, 
thei efter vou split the REM you will have your routine in^ 
line J and the NAMES in line 2. You should then SAVE both 
lines as & working copy for future revisions, then delete the 
second dine end SAVE again for merging with a BASIC program. 


Combining Eig REM and the 16K HOT Z 


You Cen combine the i6k version with Big REM so that they LOAD 
as a Single program. LOAD the two programs as described 
above. Write an 80H at 7F1F to indicate the end of a 
variebles area, then go to the systems variables area and 
charge ELINE, STREOT, and STKEND so that each holds 7F2@ 
(low-high order !). Then SAVE the whole thing from BASIC. 

When vou reLOGD., you will have to start HOT Z with a direct 
RAND USR call. You cennot write any BASIC or declare any 
BASIC variables with this version, and you should decouple the 
two per US after starting HOT Z by restoring ELINE, STKBOT, and 
STKEND io hold 4DCO. What this linking does is to make HOT Z 
leok like the variables area of a BASIC program. 


ly vou own Z-TOOLS co a comparable utility program. you can 
merae Lhe J REM'& created in this wav with BASIC programs that 
)eck e line 1. 


If vou ere not using Bia REM, or if you have completed the 
)ire-choppinag described above, and want to write a BASIC 
progran of some size with HOT Z still resident, then you 
should move RAMTOF and the stack below HOT Z before you use 
shifl-@ to ao off and write BASIC. In 64K, put RAMTOF below 
5S808H to protect HOT Z; in 16K, put it below 4Efg. 





USING THE RELOCATE COMMANDS (F-B,F-9) 


The Relocate command is rather complex in order to provide you 
a degree of flexibility in relocating your routines. A set of 
nine addresses must be entered before using the F-8 command, 
and a certain amount of planning and knowledge of the subject 
program ig required to derive the correct addresses. Simple 
programs with one or two calls or absolute jumps are best 
labelled, moved with the Transfer-with-NAaMEs (F-6) command, 
and then fixed up by hand. 


ô program of reasonable complexity will have a block of code, 
a block of date (which may include address lists or jump 
tables), and a block of variables. Good programming form 
would recommend that you keep these blocks separate and 
distinct rather than, Say. mingle data and variable storage 
in the crannies between your subroutines. If you are 

pr car emmiric with HOT Z, you can separate the blocks generously 
as vou develop your program and then use the Relocate command 
to close the gaps when you finish. Separation of code and 
date also allows you to make efficient use of the ZX memory 
architecture, since there is generally some block of memory 
that can be used far data or variables but not to run code. 
(Above 6UODUOH in unmodified machines. above COH with the 
GQiiqer modification and the standard screen driver.) So don't 
clutter up vou active memory with Gata files if you have more 
than lok af RAM. 


HOT Z"s Relocate command will work on program blocks where 
code, Gata and variables are separate and distinct. If you 
have embedded patches of data, the command may still work, but 
you should check the data after the relocation to make sure 
that it hes not been changed under the guise of readdressing 
code.  Frodrems such as the BK ROM, where jump tables lie 
eround like empty beer cans, would have to be broken up into 
segments and relocated piecemeal. 


The Relocate routine readdresses and moves Z8@ code. However, 
the command does not take account of overlapping seaments 
between source and destination blocks. so you cannot directly 
relocele a program to addresses already occupied by that 

pr egor em. (In such cases, you should use the transfer command 
firgl and then readdress in place with the relocate command.) 


dump tables have to be revised with the F-7 command, which 
first asks vou for a displacement and then adds that 
displacement to each address in the file, starting at the 
cursor anc ending at the END address. (If you moved your code 
from 4iðğH to 44ØØH then the displacement would be ØSØØH: from 
44H to 41980H would be a displacement of FDO/OH.) Jump tables 
end deta blocks should be moved with the Transfer command 
prior to using the relocate command. 
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The F-& command (Relocate) allows you to move the code block 
by one displecement, the date block by another, and the 
variablee block by a third displacement. (Any other three-way 
separation should alsa worl.) 


ADDRESS ENTRY FOR RELOCATING 


The variables TEMI through TEMS are used to set the nine 
address parameters for relocation. The nine addresses are 
three sets of three addresses. Each set of three addresses 
indicates the start and end of an address range to be changed 
and the start address of the new address range. For example, 
suppose vour program to be relocated fit the following memory 
me: 


44 D6-44E8 Variables 
44F/-44FF Data 
4g -469]90 Frooram 


Suppose vou heave ZZk and want to put the variables and data 

al BIGBH and the proaram at 404%, First. transfer the 
variables block to 19H: it will run to 8118, so transfer the 
data block to 8119-8128. You want to move the procram from 
4500 up to 404%, so any addresses of jumps or calls that lie 
belween SØG and 4680 should be changed to lie between 404% 
and 4DCw, (You don't need that last number.) So enter the 
Orjginel range in TEMI and TEM2 and the first address of the 
new block in TEMS, thus: 


TEM) 452 
TEM2 468640 
TEMS  4C460 


These first three TEM values always hold the parameters 
relating to the program (code) block. Variables and data 
parameters can go interchangeably into TEM4-TEMé or TEM7-TEMS9. 


Addresses of variables, which were at 44D£/-44EB. must be 
changed to start at B188, and addresses of data, formerly at 
S4FU—44FF, must be changed to begin at 8119, so fill in the 
remaining TEM slots as follows: 


Variables Data 

TEMA 44Dg TEM7 44F €i 
TEMS 44E8 TEM8 44FF 
TEMS 8199 TEMS 8119 


TEM4—-6 ere one block, TEM7-9 the other. Now set the cursor at 
4500 (start of the code segment) and set END to 46890, then 
Give the FUNCTION-8 command. The code will be copied to the 
new Jocaetion and readdressed to run with the new variables, 
new dale block. and any relocated subroutines in the code 
block. The original code will remain unchanged at its 
original location. 


1 
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oe gom 


die 


You may also use the Relocate command to split a code block 
into two or more separate blocks, but you must apply it 
repeatedly. once for each of the end-product blocks, and 

€ readdress for the blocks that are not being moved as if those 
blocks were variables or data. 


If vou Jack variables or date blocks, then use a single 
non-rzero dummy value for all three of the second or third set 
of TEM values, i.@., make them all three the same. 


The relocetor leaves unchanged any ROM calls or any loads to 
or from the systems variables area (49060-—-4907C). 


RELOCATING HOT Z 
In 1óF. 


Relocatina the program that does the relocating is a special 
case Of using the Relocate command. Lack of space in 16K 
prevents any useful relocation of the entire program. You 

— could, however, clear away some of high RAM by moving the 
parte of HOT Z that occupy those addresses into the work space 
below 4E,90mW9W. This would allow you to write and debug a routine 
intended to run above RAMTOF with a BASIC program. 


jc do that. beain by moving the stack with the FUNCTION-2 
Command a Set the cursor to 4D8Ø and give the command. (There 
will be mo visible on-screen effert unless you have set the SF 
display (shift-2 in READ)). Next move the HOT Z variables, 
which occupy 7F86—-7FFF, by using the Transfer-with-NAMEs 
command (FUNCTION-6). Set the cursor to 7F8Ø, set END to 7FFF 
and give the command, followed by 4D8@ as DEST. This copies 
the variables to 4D89-4DFF,. but it does not yet readdress the 
HOT Z code to use variables at the new location. To do that, 
Set the following TEM values: 





Code Data Variables 


TEM] cone, TEMA 4450, TEM7 7F BS 
TEM2 7EFF, TEMS 449, TEMB wr rr 
Nes TEMS SBH, TEMS 440%), TEMS 4D86£ 


The data entries are dummy values intended to have no effect, 
since the data tables stay put. Finally, set the cursor to 
Bø., set END to 7F2@ and give the FUNCTION-8 command. After 
that. vou may clear 7F260-7FFF with the FUNCTION-@ command and 
US il es workspace. 


If you are more ambitious still and hunary for high memory, it 
is possible to move a part of HOT Z from the high addresses 

lø your low workspace, (If not, skip the next few 

per agr ephis,) You need to pick a point in the code across 
which there are no relative jumps: 78780 is one such. Since 
this is not a simple relocation but a splitting up of the 








program. several extra steps are necessary, Assuming vou have 
alreaedv moved stack and variables, as described above, first 
relocate the code from 7879-7F2Ø to 467%. Next. we will 
reeddress code left behind (588095 -786F) to send its calls and 
jumps to the transferred block: finally, a small fix to the 
jump tables is necessary. 


For the initial relocetion, set the following TEM values: 


TEM1 78760. TEMA 444,  TEM7 4406 
TEM? 7F2ø, TEMS 444g, TEMB 4400 
TEMS 46764. TEM6 440%, TEMO 440 


Sei the cursor to 78790, END to 7F2%, and give the FUNCTION-8 
command. The first column leaves the original code in place 
and produces e relocated and readdressed version at the new 
location (4678-4D2%). The remaining columns hold dummy values 
and produce mo effect. The original section of the code will 
Stil] make ils calls and jumps to 7870 and above. so it is 
necessary to readdress that block too, 


Again, set the TEM values: 


TEMI 56, , TEMA 4440,  TEM7 7876 
TEMS 7TBOF, TEMS 444, TEME 7F2f 
TEMA BH, TEMS 444Mi, TEMS 467 


Sei ihe cursor to 5800, END to 786F and ive the FUNCTION-6& 

C Omfmencd. The first column leaves the code in place and the 
third changes any references to the high addresses to the new 
code block. The jump tables still contain a pair of 
references to the moved code, however. Change the two 78's at 
SØER and SØED to 46's. (1f vou moved a bigger chunk, you 
would have to search through the jump tables and change each 
reference to the moved block.) Now you can clear memory from 
78760 to 7FFF and use that as work space. 


Since the above relocation hems in the NAME file, you must 
eilher forego using labels or relocate the NAME file into your 
Hew workspace, which is relatively simple. 


Larger Memories 


If vou should expand your RAM or install one of the 
woditications that allow you to program parts of high RAM, 
Lhen the following relocations may be useful. 


From 16h to SZk (unmodified computer): This case allows you 
to move files and variables to high RAM, but the program must 
stil] be located below GgjoógH in order to run. The files of 
the lòk version are located at S@48-S7FF: let's move them to 
H?46-BEFF, leaving RBFO-RBFFF for variables. which are 
currently at 7F90-7FFF. Set the following TEM values: 


Code Data Variables 


TEMI 800 » TEM4 5248, TEM7 TF (gi 
TEM2 7EFF;, TEMS 97FF. TEMS 7FFF 
€ TEMS ge , TEMG E748, TEMY EF £5 


It is important first to copy the files and variables up to 
their new locations. so first transfer the data and variables 
blocks to their respective new locations, leaving the old 
copies temporarily intact. Transfer the variables 
(7FO-7FFF) first, using the Transfer-with-NAaMEs command 
(FUNCTION-6). This will change the NAME file for the new 
version. Then use the shift-T command to get to the start of 
the NANE file (4E@C). Turn on the cursor, set END to S7FF, 
and iransfer to BOO)C. (That puts 56048 into B748. etc.) 


Now set the cursor to S80, set END to 7EFF, and give the 
FUNCTION-8 command. After the return from that command, you 
May erase the original data and variables areas for vour own 
Ue, 


— This relocation requires no readdressing of jump tables 
because the code is left in place, but there is one 
small block of single-step code which is embedded in the data 
end copied out whenever the single-stepper is used. This 
block originates et £S70F-572F and will have to be readdressec 
by hand if the code block had been moved. Details of this fix 
are in Che next example. 


There is just one change to be made in the data section ta 
initialize to the new NAME file location on loading or 
restarting. The initial file location is set from the six 
bytes at REFA and following. Change BEFS and BEF7 from 4E to 
ES and BEF? from SØ to E7. 





Having done this readdressing. it is useful to make yourself a 
loader, so that you can load in the new version directly and 
don"t have to relocate every time. The easiest way to make a 
Joader is to modify the existing one by loading the entire HOT 
Z-II tape into memory and modifying it. For the example 
relocation., you can load the HOT Z-II tape as a data tape from 
gopeWw to B4ES, The code that loads HOT Z to the proper 
addresses will be at 8268 and will have to be modified. 


First, however, the readdressed program segment from S899 to 
7EFF should be copied into the loader with the transfer 
cummend. Set the cursor and END to these two addresses and 
transfer to 8DC4. Next, set the cursor to BS@C and END to 
EEFF and Urangfer to 83DØ, This moves the files into place. 
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Now modify the code at B3A8 to read as follows: 


LD HL, 43DØ 
€ LD DE, BESØG 

LD BC, @9F4 

LDIR 

LD HL.74E3 

LD DE.7F1F 

LD BC, 2720 

LDDR 

CALL gF23 

JF Agzc 


1f vou use the insert command (EDIT) before each of the first 
four instructions. vou cen preserve and use what is already 
there, but change the LD BC to 2729. 


Ready al last. SAVE from BØØS to B4ER and the resulting tape 
should load normally and initialize the relocated version. 


Orne of the hazards of loading a large program such as this is 
Lhe possibility of writing over the machine stack when you 
Copy up the progr em. ] this case, the stack ie in the 
evenliel workspace (7FØØ-7TFFF) and is sate. However, if you 
engage in non-slbendard eaddressina or have a revised ROM in 

vour mechine, then be sure the stack is in a sate place before 
]oedina HOT Zz. 


Moving HOT Z to High RAM 





If vou have a suitable memory for the project (Oliger or 
Memolech or possibly another: not a Byte-Back M-64 or a Super 
Z.) and make the Oliager modification to your computer (See SQ 
vn.) you can run machine code in the 32-48K block 
(BÜUgUH-RFFF), or if you have a separate display board, you may 
be able to use the entire 64k for proarams. In that case, you 
should convert HOT Z to run entirely in another block of 
memor v. Here's how to move the 64K version to IBMGH, keeping 
Lie variables and files in the top 16K of a 64k memory. 


(You ought to test your modificetion first by using HOT Z to 
write e Simple little routine like CALL WAZA, CALL 737E, RET 
sumewhere in the newly opened-up memory area. This just 
Cleert Lhe screen, waits for e keystroke, and comes back to 
HOT 2. but you can’t normally run it at, say, BIØØH. Set the 
cur sc Lo the first instruction and give the shift-R command 
to Buh $i. 1f it doesn't work, then either your mod 1s 
incorrect or vour memory has some prevent circuit in it.) 


Let! tlie edi. ver Sian. Set the following TEM variables: 


Code: Data Variables 
TEM) ENDE. TEM4 SØG y TEM7 GAGI 
C TEM? TP ifs TEMS ege. TEMS ggg 
TEMS 9 aig, TEMS SO0ggu , TEM9 aene 
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This will cause the program code to be rewritten at 98909 and 
following addresses with all calls and jumps readjusted but 
wills the same variable and file addresses. (Values in TEMA 
Lir ouch TEMS are dummy values that prevent anything trom 
haD ICa Use any one non-zero value for these, but keep 
Lhem all Lhe sane.) 


Sel the cursor to 586090 and END to 7F1F and aive the FUNCTION-8 
commeuncd. If vou have done things correctly to here, you will 

find the reeddressed program beginning at 980%. Don’t try to 

run jit vel, Unlike the earlier example, the jump tables must 

bo reeaddr essed because the program itself has been moved. 


The jump tables for the standard 64K version begin at F648 and 
ene et F76D., Since both copies of the program ere in memory, 
voll can just reeddress the Lables in place. Use the 
FUNCTION-7 COMMAND Lo change the jump tables. (Cursor at 
Féó4€&, sel END Lo F76D, hit FUNCTION, then 7, set DISP to 449/010, 
Liceceusc the move tr om SBA to JBE is a displacement by that 
amount, ENTER.) Now check the address at F754 and change it 
back io 44765 since that address is in the systems variables 
area, il does nol change. 


mt this point, vou are runnina commands in one version and 
control in the other, Now switch to the new version by 
seiting the cursor to SBM and divina the shift-R (Run) 

C Oea a Thei should bring up the /£9N Jp address as the program 
restarts in the new version. 


The sinale-stepper requires one more set of changes. There is 
e Swed) patch of code embedded in the data section that is 
Copied oul for single stepping. You will find it at FD9?E to 
ÅDZR (FDZC isn'L') There are seven JFP's and one CALL in that 
aree. IL is generally quicker to revise those eight addresses 
than to use the FUNCTION-8 command, though you could use it by 
setting TEM1 = FDOE, 2 = FD2B, 3 = FDOE, 4 = 58500, 5 = 7F1F, 

ó = 9390, and the other three with a dummy, say O00. If you 
revise Lhe addresses by hand, just add 49/00 to each. © 

Do» € change the JR. (The new addresses will all begin 

with either AY or AR, ) You should now have a fully converted 
versian thal rung in the 32-48F block of your modified 
computer's inemor y. 


lo make e loader for this new version, load in the original 
Lape tr cin 44057 to 794F. (You may first want to erase the old 
version el .5800-7F20 with the FUNCTION-£ command.) Now all 
vou have to do is to copy the various blocks into the 

eppr opriele spots in Lhe loader, change a few loading 
addresses, and reseve the same block to make a loadable tape. 
Gaddr esses 4449-4470 will contain the system variables that 
lior malliy load ta 4009-—427C.) 








it 47Bó. cliéeriqe-the (bDoDE s7FiF to-LD:DE;SBFIF. That will load 
Lhe prour eam to its new memory residence. At 442F, change the 
CALL 737E to CALL BIFE. That calls the relocated keyboard 
scean while the cover is on screen, At 4442. change the LD 
RC, 1468 lo LD BC, SROs. That clears away the loader after it 
has done its Job. Change the JF at 444F to JF 99,9. That 
Slertls Che proaren. 


Now sel the cursor at 986029, END to BFIF, and Transfer 
islii¢i-T) to 47D, Next. cursor at F3AØ, END set to FDFE, and 
Transfer Lo óEFÓO. If you want to change the version number 
end memor v-occupetion listing on the cover. look at 466F and 
following wills lhe data display and make the changes in the 
Edit mode. Finally. record over the initial address space 
(44v -- 794F). The resulting tape should load from BASIC, 
insted) HOT Z. and jump to the cover, just as your original 
versjon does. 
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THE ONE-STEF WINDOW 


€ The Sinale-Step display. window requires.a second full display 
file for the cumulative screen print of the routine you are 
stepping through. Since such a display file takes up 768 
bytes of memory that vou might otherwise use for programming, 
the program requires you to specify where you want to put the 
second display file. Such a file can be anywhere in memory 
since it is moved into the proper location at each step. Just 
assure that the following 768 bytes contain nothing you want 
to keep. Then set a cursor to the start of this area and give 
Lhe FUuUNCTION-9 command to initialize the file and hook the 
window into the single-step routine. 


After you have initialized the second display file. you can 
switch the single-step display window in or out with the shift 
kd command ingle-Step). If the window is "on", the screen 
will come up with a pause tor a keystroke at every step. 

Since only a few steps will actully print to the screen, you 
may want to keep the window off and refer to it only 
occasionally. Restart HOT Z (shift R in READ) to get rid of 
the window entirely and reclaim the memory space. 


The window will normallv flesh on screen for each step, but 
there will be no pause unless you first give the W command, 
then hit ENTER to run a step. Any key will take you back to 
the register display, but note that the V key is also a CLS 

€ command for your window display. A CLS puts the print 
position back to the top left screen corner. 


lf you use RST 18 to print to the display window, you can run 


ihe whole KST i19 routine in the same way you would a CALL to a 
subroutine. by hitting shift-R in single-step mode. 
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NOTES ON MAKING EPROMS 


Bat the moment. the onlv possibility of putting HOT Z-IT on 
EPROM 1s to use two 2764°6 (or a 27128) or the equivalent with 
some kind of modified memory system. This means you will have 
Some exire Space for your Own routines as well, and you may 
want Lo hook up some of them to HOT Z. 


The commend lists have two kinds of user-slots for extra 
Commands. marked as "Dead keys" and "User hookups”. If you 
work entirely in RAM, then treat both categories as equal. 
Just repieace the current address in that jump-table slot with 
Lhe address of the routine you want to run as a command for 
Lic corresponding key. 


I$ vou make vour own EFROMs of HOT Z, then vou have to treat 
Deed keves Įangd User Hookups as quite separate opportunities. 
Dead kevs will be truly deed in EFROM unless vou enter an 
address before vou burp am EFROM. lf you have space for your 
favorite routines on the same EPROM with part of HOT Z, then 
vou should book up those addresses before you burn the 

EFRON. User hookups are still available atter you burn the 
EPROM because they allow you to hook in routines you have just 
tar diller into eddress slote in the variables area. Addr eases 
for lisese &lolts ere Listed on the command sheets. it is often 
handy to look new routines of any sort into HOT Z and to run 
Lem aS Commands. 


Host available slots have been left amona the Write commands 
because those commands allow the greatest. flexibility. If you 
Went to add to that flexibility, write your own command 
processor and make the entry into that a HOT Z command. That 
ie roughly how HOT Z ties together the Read command mode with 
the Write modes and the single-step. I use a jump table for 
«ll commend-processing loops and advise anyone using HOT Z to 
Leake ihe same approach because there is a lot there that you 
Cen borrow, (For example, a CALL to this versions KEYRoard 
routing will] preserve all register values except for the 
eCcumulaior,. which comes back with the code of the first key 
pr esset. Ii does use the EXX registers.) 


With = brile commend. vou should have the cursor address 
available to you as well as the END address. The END address 
is ejwavs available by loadina from the HOT Z variable EOFA. 
vii cd: is included in the permanent NAME list. The cursor 
edd: ess should be read at the start of a routine with a CALL 
ERED (cur Sor -addr ess read), which brings back the cursor 
address in HL and updates it in the HOT Z variable KADD 

(Cur for eddr ess», ERED is the address in the first CALL for 
the H kev rouline. tor example, which is listed on your 
Command Sheet, KRED pute the cursor address in HL and into 
Lhe HOT Z variable BADD. 





If you have a routine that you want to make into a Write 
command. then you should decide what mode of HOT Z you want to 
return Lo. even if only eventually. A routine that ends in a 
RET must not destroy the existing screen, or it will have no 
context to return to. (IL will come back, though, to an 
anonymous address and in Write mode but with no cursor, at 
which point vou should press ENTER.) If you want to use the 
screen then you should choose to return to Read mode, which is 
the "home base" of HOT Z. To do that, you should FOF the 
first RETurn address and dispose of it, then load HL with the 
address CHOO and do an EX (SF),HL. If you do that, you can 
even control the address to which the HOT Z display returns by 
loading CADR before you RETurn. 


In other words, if you want to use the screen, and to know the 
address et which the command was issued. prefix your routines 
with: i 


FOF HL 
LD HL. CHOO 
EX (SF),HL 


and end them with & RET. 


Commands that do not use the screen can restore the cursor 
position with a CALL KRES. You can move the cursor one line 
down with CALL EDWN or move it up with CALL K-UF, either just 
before ihe RET. 


Commands appended io the single step may need to use the 


address in the NEXT slot, which is stored in the variable NOSI 
(next one-step instruction). 
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THE FLOATING-FOINT INTERPRETER 


RST 28H is the entry into the ROM's Floating-point operations, 
which are coded in the bytes between an RST 28 and the 
following 34H. There is a good explanation of this second 
lanquade (Or is it third?) of the ZX in Dr Logan’s article in 
SYNC 2.2. (Hut beware of the two sign tests, which aren't 
jumps, es labelled in SYNC.) 


HOT Z will read this floating-point language, but only after 
you turn on the floatino-point interpreter (shift-W in READ). 
If you leave the floating-point interpreter turned on, you 
will get a true reading of the ROM, but problems can arise 
elsewhere in memorv when you encounter an EF that functions as 
date rather than an RST 28. You may get locked into the 
floating-point interpreter mode, without a 34H. the END 
Character, in sight. The way out from this barrage of 
Qibberish is the shift-W command again, which switches out the 
floating-point interpreter entirely. Other times you may want 
to read it, because this extra language is really one of the 
treats of the Sinclair-calculator heritage. 


The f-p interpreter is also turned off by entry of a numerical 
address, but not by a page flip or a NAME, so use the last two 
when you're working with f-p. in addition, there is a special 
key command, TO in READ møde, which switches the flag that 
tells the disassembler which language it's in. 


The TO command (READ) has a dual purpose. It will aet you out 
of floating-point mode (without turning off the interpreter) 
if you need to and can't, or it will get you in when you want 
to be but eren"t. You may get stuck in that mode through 
addressing yourself into the middle of a Z89 instruction, for 
example. Since floating-point operations include jumps and 
loops, there are also inclusions of f-p code that do not begin 
with am RST 28, branches of jumps. The TO command will get 
you into those branches. However, the command is just a bit 
switch and it doesn't function when the screen page itself 
switches from one lanauage at the top to the other at the 
bottom. The cure, when the TO command doesn't function is the 
cute trick of hitting the shift-D key twice. This picks up 
the language mode from the bottom of the page to the top and 
reverses the reading of any bytes from one language to the 
olher. 


rou wili also encounter some queer behavior if there is f-p 
cote el the bottom of the screen and you try to write or go to 
the One-Step. This is not generally fatal and can be cured by 
aging back to disassembly and setting the screen so that it 
ends in ZEA disassembly. If you want to write f-p code, the 
only manageable way is to go into EDIT mode (shift-E). 
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Another consequence of jumps in the f-p language is that an 
RST 28 may be embedded in a run of f-p language as a second 
eniry point. In these cases, EF gets misread as GET F, which 
is a particle of nonsense, but it really is an RST 28. and 
would reed as such if vou called it by address to the top of 
the screen. 


Floatina-point operations are FORTH-like stack manipulations 
and easy to follow if you know something about that language. 
They use the MEM area of the systems variables as storage 
slots for six floating-point numbers. (Each is five bytes.) 
The f-p operations that transfer between the calculator stack 
and MEM are called GET and STOR and are followed by a single 
digit from £6 to $5 to indicate the slot used. Numbers or 
letters higher than 5 generally indicate a patch of nonsense 
with GET, STOR and STAK as well. 


Many of the possible f-p operators do not occur in the coding 
of the ROM, where you are likely to encounter them with HOT Z. 
They occur instead during the ROM's reading of BASIC programs, 
and they ere generally identical with a BASIC instruction. 

You could learn to write floating-point code with these and 
the purely machine-code f-p operators if you wanted to; it 
would be similar to BASIC and a little faster. The ‘entry 
point’ of these BASIC f-p operators into the real machine 
world is through the operation labelled RAFF (Run A as 
Floalina-Foint). However, you need only use the command 
numbers listed as the first column of the instruction list to 
perform those BASIC functions on whatever floating-point 
numbers are on the calculator stack. From the perspective of 
a HOT Z user, RAFF would be used only to run an operation that 
resulted from some calculation, whose result was a code in A. 


Two of the f-p operations deliver data directly from the code 
listing to the calculator stack. They generally do this in an 
efficient way, using fewer than five bytes, if possible, to 
encode the five-byte floating-point number. HOT Z prints the 
encoded floating-point number in the NAME and mnemonics 
columns of the disassembly listing. Since the interpreter 
doesn't know where any number will end, it is necessary to 
begin all of them slightly out of column, or the longest would 
poke out the line-ends in the display file. The f-p 
interpreter also reads the full five hex bytes that go onto 
Lhe f-p stack, rather than the condensed version that actually 
occur & ir the ROM. The ADDR column keeps accurate track, and 
you can work out the extra bytes, which are generally trailing 
Leroes, from that column. 


HOT Z prints floating-point data by using the same ROM 
routines that handle that data, so the disassembly slows down 
and becomes jerky when it has to print those huge numbers, or 
their single-digit versions. 
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The two data-stacking operations are labelled STFF (stack 
floating point) and SAFF (successive approximator: we've ail 
mei care). The first of these puts one five-bvte number on the 
calculator Stack, the second a series of-one to 31 (whatever 
is lefi when you AND the low nibble of the instruction byte 
wilh £F) five-byte f-p constants. (That's 5 to 155 bytes.) 


When either of these operations gets stuck near the bottom of 
the screen without enough space to display all its floating 
points, then thal same operation will begin again after the 
next page flip (F command) and boringly redisplay its whole 
reper torv of numbers. The successive approximator in the ROM 
uses anything from six to a dozen floating point constants to 
get to « value for Chebyshev polynomials to approximate the 
{ranscendental BASIC functions. 
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FLOATING FOINT 


Code Co 
QU JRT 
: SWOP iAre 
U- DRUP 1] 
e": SUB i 

i NHELT —17L 
CH DIV ide 
Zico PWA iDEZ 
07 .OR 14ED 
ag AND Lars 
ntc Nc =M 


Addr 


Beso tet 
T1 

m 

i 


i LI 
GA N2M Libis 
QE NCOM LEDS 
SUL NOM IEZI 
mit NaM LES 
HE o NM i BECA 
mar ADD LZOO 
iG SAND LARS 
1i <= inagi 
a >= lun 
S sc» ipe 
ye. «4 LEST 
i 4 12352 
6 - lips 
17 $TR+e  1E52Z 
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OPERATIONS 


Description 


jumps ir stacy tor hoige a true 

Exchanges the top and cecong D-Dvte stack entry 

Throws away tog stack entry 

tubtracte top stack tros second stack entry 

Multislies tap two stack entries and leaves product on staci 
D:vises second entry oy tcp stack anc leaves quotient on staci 
Raises žag on stack to power of stack too 

Performs BESI OF on two ton stack entries ang iezves result 
Fertoras BASIC AND on tc top stack entries. igaves result 
Rumeric inecuelity test 

Nussrir inzQualitv test 1 
Numeric inezualitw test 

Kugeric ineque.ity test 

Kugeric ineguelity test 

Nugeric sauglity test 


fics tec tos stack entries anc ie 
ADs s string with a nuater 
String inequality tesi 

string inesuality test 

String inegqugiicy test 

String imecugiity test 

String inequality test 


en 


enualliv test 
Corcaienztes the string: acore 
Changes tne sign of top stack ent 
Replaces top stack entry with its 
BASIC function 


tri 


4 C S 
ctw 


mi 
ecc LN 
EXP 
48 INT 
SOR 
26  SGN 
27 ABS 
28^ PEEK 
uM USE 

-  STEK$ 
2E CHRS 
ctc AMET 
ID DUFF 
sc: — QREM 


18913 
iD 
iDS= 
i DSE 
iD 
iDD4 
invé 
ice? 
IGCSE 
il4e 
iDDE 
LAA 
LARS 
LARE 


BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIL 
Basic 
BASIC 
BASIC 
BASIC 
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Basle 
BASIE 
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READ Mode Command File 


File 
(64K) (16K) 
F65E SSE 
F64C Se@4C 
F660 506909 
F656 5058 
F662 5062 
FSSC SMSC 
F648 59048 
F664 564 
F64E  SQA4E 
Fé5o 5950 
F652 59052 
F654 5954 
F656 og 
Fé44 S644 

. Feé5p 5959 
F666 S066 
F668 5768 
F&å6A  S506n 
F66C  S96C 


Key 


(Shift) 


D D 
Z 
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PUNH 


aay 


Routine Function 


7ES£ 
&3DE 
6474 
euco 
6304 


SDSS 
5D68 
Bgg 
65E4 
SCF 5 
SEC 1 
63E7 
SCEC 
esFe 


~D71 
6888 


Single-Step Command File 


File 
(64K) 


F6DA 
F6CB8 
F6DC 
F6D4 


FDE 
F6D8 
F6C4 


F6CA 
Fe6D6 


FéeCE 
FD 
FóD2? 
F6C6 
F6CC 


(16K) 


SDA 
Sopnce 
SgDC 
9gb4 


SØDE 
SØDE 
3gc4 


o9 tgca 
J3g8D6 


SCE 
SDE 
ogDa 
SCS 
SACC 


Key 


(Shift) 


A 

AND 

D 

E 
EDIT 
ENTER 


-gtuoonmoTrruomn 


Routine 


6435 


A7DØ 


A946 
&3FD 


6581 
64A3 
6423 
6469 
645D 
esce 
es3F 9 


Turn on assembly editor 
Stack pointer display switch 
Switch to data display 
Switch to edit 

Fix display file 

Dead key 

Switch NAME file 

Quit to BASIC 

Restart HOT Z (also RAND USR 22528) 
Switch to Single-Stepper 

Display top of NAME list 

Decimal address to follow 

Switch floating-point display 

Switch off floating-point interpreter 
Frint screen 


Dead key. 


User hookup (Routine addr at 7FAM/FEA®) 
User hookup (Routine addr at 7FAZ/FEA2) 


Function 


Dead key 

Display breakpoints 

User hookup (Routine addr at 7FAA/FEAA) 
Dead key 

Back up one byte 

Run one step 

User hookup (Routine addr at 7FAC/FEAC) 
Go to breakpoint 

Dead key 

Quit single-step for disassembly 

Run CALL or RST 

Set register value 

Skip step 

Twin breakpoints 

Set breakpoint 2 

Set breakpoint 1 

Window switch 

Print screen 


WRITE Command File 


File Key Routine Function 
(64K) (16K) (Shift) Addr 
F684 5084 SFSA Assembly mode 
F672 59072 5a61 LOAD from cursor to END 
F686 56086 SEZ 7 Display switch to DATA 
F67E S@7E SF6S Edit mode 
F688 56088 SCe4 FIND string marked by cursor and END 
F682 5082 SBAEB Christen with NAME 
F66E SM6E SF7D Delete instruction at cursor 
F&BA 5084 SRIE Hex sum and difference of cursor and END 
F674 S274 5D47 RUN code at cursor (RET to READ) 
F680 See 65E RS Single step instruction at cursor 
F678 5078 5847 Transfer 
Fó765 59720 SDD6 Delete NAME 
F67C | 5S97C 67 6 Set END variable 
Fe70 $5079 S062 SAVE from cursor to END 
F676 59076 SDée4 Frint from cursor to END+ 
Set INSERT cursor 

ENTER Quit to READ mode 
Feégc Sesc F. SECS Clear memory from cursor to END 
F6éBE  SPBE F-1 SER I Fill memory with specified character 
F692 SØ PZ ICCA Move RAMTOF to cursor, stack just below 
F692 $092 F-S Dead key 
F694 5094 F-4 a 
F696 S096 F-5 E 
F698 598 F-6 584D Transfer code and NAMEs to DEST 
F6E9A SIA F-7 937 Readdress a jump table by displacement 
F69C S9C Pt 39817 Relocate code from cursor to END 
F69E  SP9E Peg &3AF Initialize window for single-stepper 
Feng SWAG F-A Dead key 
F64A2 Søn? F-E ti 
F6A4S  5Søn4 F-C " 
FOAG SWAG F-D pe 
F6AB  SøØRA8 F-E P 
F668 S58 F-F oco6 Find next occurrence of string 
FEA SAAC FF (5 Dead key 
FCAE  SØRAE F-H " 
FOR SAR F-I på 
F6RB2 SWE F-J " 
Fe6R4  S,0r4 F-k " 
F6HS SMES F-L » » 
FRB SWS F-M x | 
FORA SWRA F -—N E 
FeRBC X SORBC F-QO å 
FORE  SHBE F-F 6152 User hookup (Routine addr at 7FA4/FEA4) 
FoC  SO,OCg F (3) ASFS i 7FA6/FEA6) 
F6C2 59C2 F-R A66D x 7FAB/FEAB) 
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